TMAPISend Delphi Component   6/95
Microsoft Mail 'MAPISendDocuments' Function

It is important to read this file as there is no online help included
with this component.  These files are considered freeware, with complete 
source included.

If these files MAPISEND.PAS, MAPISEND.DCU, and MAPISEND.DCR are copied 
into your \DELPHI\LIB directory, you can simply install the TMAPISend
component using 'Options' 'Install Components' and specify MAPISEND.PAS.
The MAPISend component is then made available in the 'Sample' section of
your palette.

The component itself is actually very simple and is modeled using the 
MAPISENDDocuments function of Microsoft's MAPI.DLL.  There are simple
properties and a single function of 'Execute'.

To use the component within your Delphi application, simply click on
the MAPISend component button in your palette, and place it onto your
form.

The five properties are as follows:

Delimiter:   The single character delimiter which separates filenames
             of those files which are to be attached and their
             corresponding paths.  MUST NOT BE A RESERVED DOS FILENAME
             CHARACTER!  (a semicolon is best)
FileNames:   Names of each of the files to be attached to a MS Mail
             message, separated by the character specified in the 
             'Delimiter' property.  These are the names as you wish them
             to appear in the message. (ie MYFILE.TXT)
FilePaths:   Actual filenames and paths of those files to be attached to
             the MS Mail message, separated by the character specified in
             the 'Delimiter' property.  These are the names and paths of
             the actual files to be attached (ie C:\MYFILES\MYFILE.TXT)
Name:        Name of the component. 
Tag:         Standard tag included in all components.

The first three properties may be either defined at design time or run 
time.  Invalid filenames, etc. are handled by the MAPI resource, however
it may be wise to include validity checks before assigning property values
to the TMAPISend component, as it does not include them.  Once they are
defined, (assuming your TMAPISend component's name is MAPISend1) a simple:

MAPISend1.Execute;

will produce a send mail dialog along with the files you have indicated in
the components properties as attachments.

Most importantly, don't forget that in order for it to work properly, 
Microsoft Mail's MAPI.DLL must be in the path and a fully functional
installation of Microsoft Mail must be present.  (This component was
developed on a platform using version 3.0b.  Consult the MS Mail technical
reference for version compatibility.)

I have tested this component thoroughly and it seems that there are no
problems, and it is a quick way to mail enable your application.

I am no expert on MAPI functions, although I have some experience in 
mail-enabling ObjectPal and Delphi applications.  However, if you have
any questions, feel free to drop me a line.

Kevin Savko
75024,2760